W06-1. Kubernetes 입문 - 강의 노트
6주차 강의 노트: Kubernetes 입문 (구조 · 클러스터 · Pod)
- Kubernetes 가 무엇을 해 주는지, 왜 "선언형" 인지 설명할 수 있다.
- 클러스터 구조(Control Plane 과 Worker Node, 주요 구성 요소)를 그림으로 설명할 수 있다.
- Kubernetes 의 가장 작은 실행 단위 Pod 를 이해하고, YAML 로 직접 띄울 수 있다.
kubectl기본 명령(get, describe, logs, exec, port-forward, apply, delete)을 쓸 수 있다.
진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)
- Compose:
compose.yaml에 원하는 상태를 선언 →docker compose up -d - 한계: 서버 한 대 안에서만, 같은 서비스를 여러 개 띄우면 포트 충돌
1. Kubernetes 가 해 주는 일
Kubernetes(쿠버네티스, 줄여서 K8s)는 여러 대의 서버를 하나의 거대한 컴퓨터처럼 묶어서 컨테이너를 운영해 주는 시스템입니다. 이런 일을 컨테이너 오케스트레이션이라고 부릅니다.
| 운영 고민 | Docker / Compose 만 쓸 때 | Kubernetes |
|---|---|---|
| 어느 서버에 띄우지? | 사람이 서버를 골라서 접속 후 실행 | 알아서 빈 서버를 골라 배치 (스케줄링) |
| 컨테이너가 죽으면? | 같은 서버 안에서만 재시작(--restart) |
다른 서버에서라도 다시 띄움 (자가 치유) |
| 사용자가 늘면? | 사람이 서버에 들어가 하나씩 추가 | 숫자만 바꾸면 늘어남, 자동으로도 가능 (스케일링) |
| 여러 개 앞의 주소는? | 직접 로드밸런서 구성 | Service 가 하나의 주소로 나눠 줌 |
| 새 버전 배포는? | 끄고 → 새로 켜기 (서비스 중단) | 하나씩 바꿔 끼우는 무중단 배포 |
그리스어로 "배의 조타수" 라는 뜻입니다. 로고가 배의 키(타륜) 모양입니다. K 와 s 사이에 글자가 8개라서 K8s 라고 줄여 씁니다.
Google 이 내부에서 쓰던 시스템(Borg)의 경험을 바탕으로 2014년에 공개했고, 지금은 CNCF(Cloud Native Computing Foundation)가 관리하는 사실상의 표준입니다.
2. 핵심 사상: 선언형 + 조정 루프
flowchart LR
U["나: 원하는 상태를 선언
'방명록 Pod 3개'"] --> A["Kubernetes
(저장)"]
A --> L{"현재 상태 =
원하는 상태?"}
L -- "아니오: 2개뿐" --> F["차이를 없애는 조치
(1개 더 띄움)"]
F --> L
L -- "예" --> W["계속 지켜봄"]
W --> L
에어컨에 "24도" 를 설정해 두면, 에어컨이 실내 온도를 계속 재면서 차이가 생길 때마다 알아서 냉방을 켜고 끕니다.
Kubernetes 도 똑같습니다. 우리는 "방명록 3개" 처럼 원하는 상태만 적어 두고, Kubernetes 가 현재 상태를 계속 확인하며 차이를 메웁니다. 이것을 조정 루프(Reconciliation Loop) 라고 합니다.
그래서 Pod 하나가 죽으면 사람이 손대지 않아도 다시 3개가 됩니다(7주차에 직접 확인).
3. 클러스터 구조
Kubernetes 를 이루는 서버 묶음을 클러스터, 클러스터를 이루는 서버 한 대 한 대를 노드(Node) 라고 부릅니다.
flowchart TB
K["kubectl
(내 노트북)"] -- "명령 (API 요청)" --> API
subgraph CP["Control Plane (관리 본부)"]
API["kube-apiserver
모든 요청의 창구"]
ETCD[("etcd
클러스터 상태 저장소")]
SCH["kube-scheduler
Pod 를 어느 노드에?"]
CM["kube-controller-manager
조정 루프들"]
API --- ETCD
SCH --- API
CM --- API
end
subgraph N1["Worker Node 1"]
KL1["kubelet"] --> CR1["containerd"] --> P1["Pod"]
KP1["kube-proxy"]
end
subgraph N2["Worker Node 2"]
KL2["kubelet"] --> CR2["containerd"] --> P2["Pod"]
KP2["kube-proxy"]
end
API --- KL1
API --- KL2선(---)은 서로 주고받는다는 뜻입니다. 모든 구성 요소는 apiserver 와 양방향으로 통신합니다.
3-1. Control Plane: 관리 본부
| 구성 요소 | 하는 일 | 비유 |
|---|---|---|
| kube-apiserver | 모든 요청을 받는 유일한 창구. kubectl 도, 다른 구성 요소도 모두 여기를 거침 | 본사 민원 창구 |
| etcd | 클러스터의 모든 상태(원하는 상태 + 현재 상태) 를 저장하는 데이터베이스 | 본사 장부 |
| kube-scheduler | 새 Pod 를 어느 노드에 둘지 결정 (자원 여유 등을 보고) | 배차 담당 |
| kube-controller-manager | 원하는 상태와 현재 상태를 비교하며 차이를 메우는 조정 루프들의 모음 | 현장 감독 (에어컨의 온도 조절기) |
3-2. Worker Node: 실제로 컨테이너가 도는 서버
| 구성 요소 | 하는 일 | 비유 |
|---|---|---|
| kubelet | 자기 노드에 배정된 Pod 를 실제로 띄우고 상태를 보고 | 각 현장의 현장 소장 |
| containerd (컨테이너 런타임) | 컨테이너를 실제로 실행 (1주차의 containerd + runc 그대로!) | 작업자 |
| kube-proxy | Service 로 들어온 트래픽을 Pod 로 전달하는 네트워크 규칙 관리 (8주차) | 교통 정리 |
노드에서 컨테이너를 실행하는 것은 1주차에 본 containerd + runc 입니다. 그래서 4주차에 Docker 로 만든 이미지를 Kubernetes 가 그대로 실행할 수 있습니다.
3-3. 명령 하나가 처리되는 흐름
kubectl apply -f pod.yaml 을 실행하면:
sequenceDiagram
participant U as kubectl
participant A as kube-apiserver
participant E as etcd
participant S as kube-scheduler
participant K as kubelet (노드)
U->>A: Pod 를 만들어 주세요 (YAML)
A->>E: "원하는 상태" 저장
S->>A: 배정 안 된 Pod 발견 → 노드 2 로 배정
A->>E: 배정 결과 저장
K->>A: 내 노드에 배정된 Pod 확인
K->>K: containerd 로 컨테이너 실행
K->>A: "Running" 보고 → etcd 에 현재 상태 저장구성 요소끼리 직접 명령하지 않고, 모두 apiserver 를 통해 상태를 읽고 씁니다. 그래서 하나가 잠시 멈춰도 다시 살아나면 상태를 보고 하던 일을 이어 갑니다.
4. 실습 환경: Docker Desktop 의 Kubernetes
| 방식 | 특징 |
|---|---|
| Docker Desktop 내장 (kind 방식) ← 우리가 쓸 것 | 클릭 몇 번으로 생성, 노드 여러 개, 버전 선택 가능, 4주차 이미지를 바로 사용 |
| minikube, kind(단독), k3d | 노트북용 클러스터 도구. 원리는 같음 |
| 관리형 K8s (EKS, AKS, GKE, NHN NKS, Ncloud NKS 등) | 클라우드가 Control Plane 을 대신 운영 (10주차) |
노드 하나하나가 컨테이너로 만들어집니다. 그래서 노트북 한 대로도 "서버 3대짜리 클러스터" 를 흉내 낼 수 있습니다. 실습에서 docker ps 로 노드 컨테이너를 직접 봅니다.
kubectl 은 따로 설치하지 않아도 됩니다
Docker Desktop 이 Kubernetes 클러스터를 만들 때 kubectl 명령 도구도 함께 설치합니다.
5. Kubernetes 오브젝트와 YAML
Kubernetes 에서 관리하는 모든 것(Pod, Service, Deployment …)을 오브젝트(리소스) 라고 합니다. 모든 오브젝트는 같은 뼈대의 YAML 로 표현합니다.
apiVersion: v1 # ① 이 종류를 정의한 API 버전
kind: Pod # ② 오브젝트 종류
metadata: # ③ 이름표: 이름, 라벨 등
name: guestbook
labels:
app: guestbook
spec: # ④ 원하는 상태 (내가 쓰는 부분)
containers:
- name: web
image: 내아이디/guestbook:v1
ports:
- containerPort: 8000
# status: # ⑤ 현재 상태 (Kubernetes 가 채움, 우리는 안 씀)
| 필드 | 누가 쓰나 | 의미 |
|---|---|---|
apiVersion, kind |
나 | 무엇을 만들지 (Pod 는 v1, Deployment 는 apps/v1 …) |
metadata |
나 | 이름과 라벨(분류용 꼬리표) |
spec |
나 | 원하는 상태 |
status |
Kubernetes | 현재 상태 (kubectl get pod -o yaml 로 볼 수 있음) |
kubectl explain
kubectl explain pod.spec.containers 처럼 치면 어떤 필드가 있는지 설명이 나옵니다. 인터넷 검색보다 정확합니다(지금 클러스터 버전 기준).
6. Pod: Kubernetes 의 가장 작은 단위
Kubernetes 는 컨테이너를 직접 다루지 않고 Pod 라는 포장 단위로 다룹니다.
flowchart TB
subgraph POD["Pod (IP 하나: 10.244.1.5)"]
C1["컨테이너: web
guestbook:v1"]
C2["(필요하면) 보조 컨테이너
로그 수집 등"]
V[("공유 볼륨")]
C1 --- V
C2 --- V
end| 특징 | 설명 |
|---|---|
| 컨테이너 1개 이상의 묶음 | 보통은 컨테이너 1개 = Pod 1개. 꼭 붙어 다녀야 하는 보조 컨테이너(사이드카)가 있을 때만 여럿 |
| IP 하나를 공유 | Pod 안 컨테이너끼리는 localhost 로 통신 |
| 일시적(Ephemeral) | Pod 는 죽으면 그걸로 끝. 같은 Pod 가 되살아나는 게 아니라 새 Pod(새 이름, 새 IP) 가 만들어짐 |
| 노드 하나에서만 실행 | Pod 하나가 여러 노드에 걸쳐 있지 않음 |
오늘은 연습을 위해 Pod 를 직접 만들지만, 실무에서는 Pod 를 직접 만들지 않습니다. Deployment(7주차)가 "Pod N개 유지" 를 책임지게 합니다.
오늘 실습에서 Pod 를 지우면 그대로 사라지는 것을 확인합니다.
Pod 의 상태
| STATUS | 의미 |
|---|---|
Pending |
노드 배정을 기다리거나, 이미지를 받는 중 |
ContainerCreating |
노드에 배정되어 컨테이너를 만드는 중 |
Running |
실행 중 |
Completed |
할 일을 마치고 정상 종료 |
ErrImagePull / ImagePullBackOff |
이미지를 받지 못함 (이름·태그 오타가 가장 흔함) |
CrashLoopBackOff |
컨테이너가 계속 죽었다 살아났다 반복 (앱 에러) |
7. Namespace 와 Label
| 개념 | 설명 | 비유 |
|---|---|---|
| Namespace | 클러스터 안을 논리적으로 나눈 공간. 같은 이름의 오브젝트도 Namespace 가 다르면 공존 가능 | 회사 안의 부서 |
| Label | 오브젝트에 붙이는 키: 값 꼬리표. 골라내기(selector)에 씀 |
분류 스티커 |
기본으로 있는 Namespace:
| 이름 | 용도 |
|---|---|
default |
-n 을 안 주면 여기에 만들어짐 |
kube-system |
Kubernetes 자체 구성 요소 (건드리지 않음) |
kube-public, kube-node-lease |
시스템용 |
Deployment 는 "app: guestbook 라벨이 붙은 Pod 를 3개 유지", Service 는 "app: guestbook 라벨이 붙은 Pod 로 트래픽 전달" 처럼, Kubernetes 의 오브젝트들은 라벨로 서로를 찾습니다.
8. kubectl 기본 명령
kubectl 명령은 kubectl <동사> <종류> [이름] [옵션] 모양입니다.
| 명령 | 하는 일 | Docker 에서는 |
|---|---|---|
kubectl get pods |
목록 | docker ps |
kubectl get pods -o wide |
목록 + IP, 노드 | |
kubectl describe pod 이름 |
상세 정보 + 이벤트(무슨 일이 있었나) | docker inspect |
kubectl logs 이름 |
로그 | docker logs |
kubectl exec -it 이름 -- sh |
안에 들어가기 | docker exec -it |
kubectl port-forward pod/이름 8080:8000 |
내 노트북 포트 → Pod 포트 연결 (테스트용) | -p 와 비슷 |
kubectl apply -f 파일.yaml |
파일 내용대로 만들기 / 바꾸기 (선언형) | docker compose up -d |
kubectl delete -f 파일.yaml 또는 kubectl delete pod 이름 |
삭제 | docker rm |
kubectl run 이름 --image=... |
Pod 하나를 명령으로 바로 만들기 (명령형, 테스트용) | docker run |
무언가 안 될 때는 순서대로 봅니다.
kubectl get pods→ STATUS 확인kubectl describe pod 이름→ 맨 아래 Events 확인 (이미지·배정 문제는 여기서 보입니다)kubectl logs 이름→ 앱 에러 확인
핵심 요약
6주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① K8s 여러 서버를 하나처럼: 배치 · 자가 치유 · 스케일 · 무중단 배포
② 사상 원하는 상태를 선언 → 조정 루프가 현재 상태를 맞춤 (에어컨)
③ 구조 Control Plane: apiserver(창구) · etcd(장부) · scheduler(배차) · controller(감독)
Worker Node : kubelet(현장 소장) · containerd(작업자) · kube-proxy(교통)
④ YAML apiVersion · kind · metadata · spec (status 는 K8s 가 채움)
⑤ Pod 가장 작은 단위, 컨테이너 1+개, IP 하나, 죽으면 끝 (새 Pod 가 생길 뿐)
⑥ 분류 Namespace = 부서 / Label = 꼬리표 (오브젝트끼리 라벨로 찾음)
⑦ kubectl get → describe(Events) → logs : 장애 대응 3종 세트
참고 자료
더 깊이 보고 싶다면 (볼트 내 정리 노트):
- 쿠버네티스 파트 1: 오케스트레이션, 컨트롤러 = 에어컨 비유
- 쿠버네티스 개요1: 아키텍처, 매니페스트 구조, 멀티 컨테이너 Pod
- 클러스터 아키텍처와 컴포넌트, Pod, Namespace: 개념 노트
공식 문서:
- Kubernetes 구성 요소: https://kubernetes.io/docs/concepts/overview/components/
- Pod: https://kubernetes.io/docs/concepts/workloads/pods/
- Docker Desktop Kubernetes: https://docs.docker.com/desktop/use-desktop/kubernetes/